home *** CD-ROM | disk | FTP | other *** search
Text File | 1996-02-22 | 6.5 KB | 201 lines | [ TEXT/ttxt]
ARA Scripting Extension © 1996 Guillaume Besse, Full Resource eMail : guyom@fra.fr Guillaume Besse 15, rue Brown Sequard 75015 Paris France What is ARA ? ARA stands for "Apple Remote Access". ARA is a software set that enables a dialup connection to maintain the AppleTalk network protocol. With ARA, you can mount a remote server as if it was local to your machine, or access whatever service is available on the network you are connected onto. What is an OSAX ? An OSAX is an Apple Scripting Extension, an piece of software that extends the standard AppleScript vocabulary. What is a ShareWare ? This piece of software is distributed as ShareWare. This means that if you use it, you should send me FF100 or US$25. Then you will receive the latest full version, and be notified each time a new release appears. What is "ARA Scripting Addition" ? The "ARA Scripting Addition" adds new commands to open, get information about, and close ARA connections. How do I install it ? To install ARA Scripting Addition, you need a system (> 7.0) supporting AppleScript. Just drag the file "ARA Scripting Addition" to your system folder. It will be automatically put in the Extensions folder. New AppleScript commands ara connect file string [asynchronous boolean] [tarification level integer] -- not yet implemented Opens a connection using the file whose path is given as a direct parameter. Set the asynchronous parameter to true to open the connection asynchronously, and to false to open it using the ARA modal progress dialog. ara connect string [username string] [password string] [asynchronous boolean] [compatibility version1/version2/version3/versionX] -- not yet implemented [tarification level integer] -- not yet implemented Opens a connection using the specified username and password. If there is no username specified, the connection is opened in guest mode. Set the asynchronous parameter to true to open the connection asynchronously, and to false to open it using the ARA modal progress dialog. ara disconnect [asynchronous boolean] Closes the current connection. Set the asynchronous parameter to true to close the connection asynchronously, and to false to close it using the ARA modal progress dialog. ara status Result: integer This call returns an integer describing the state of the connection. ara error number Result: integer This call returns the number of the error which occured on the last call of an ARA command. ara error string Result: string This call returns the textual description of the error which occured on the last call of an ARA command. ara user name Result: string This call returns the username with which the current connection was opened. ara server name Result: string This call returns the name of the ARA server to which you are currently connected. ara message Result: string This call returns the message describing the current connection status, like "Connected at 14400 bauds". ara is answering Result: boolean True if we are currently answering an incoming call. ara is calling Result: boolean True if we are currently calling a remote ARA server. ara is aborting Result: boolean True if we are aborting a connection attempt, a running connection, or an incoming call process. ara is connected Result: boolean True if we are currently connected to a remote computer via ARA. ara is disconnecting Result: boolean True if we are currently disconnecting from a remote computer. ara is guest Result: boolean True if the current outgoing connection is made in guest mode. ara connection is v2 Result: boolean True if thje current connection is using the version 2 of the ARA protocol. ara is notifying Result: boolean True if we are notifying the user that a current connection is running. ara connection is multinode Result: boolean True if the ARA connection allows access to other computers on the server's network. ara connection time Result: integer Returns the numbers of seconds since the connection started. Negative if there is no connection running. ara time left Result: integer Returns the number of seconds remaining before the remote server closes the connection. Negative if there is no connection running. ara is client only Result: boolean True if the ARA software currently installed on this machine is for client only. False if this is a server. ara is multiport server Result: boolean True if the ARA software currently installed on this machine is a multiport server, accepting several connections at the same time. ara is version 2 Result: boolean True if the ARA software currently installed on this machine is version 2. ara is version 3 -- not yet implemented Result: boolean ara osax version Result: string Returns the version of this OSAX. ara osax help Result: string Returns the help text about this OSAX. ara shareware info Result: string Returns shareware information about this OSAX: registering, etc. Distribution This software is not in the public domain; rather it is Copyright ©1996 by Guillaume Besse. You may freely copy and distribute this software, provided that it you do not charge for it. This software may be included in any disk or CD-ROM library of public domain and shareware software sold by a NON-PROFIT organization. This software may not be included in any commercial software collection sold for profit, nor may it be bundled with any commercial software, hardware, books, or other media without the prior written consent of the author. Whenever it is distributed, the "ARA Scripting Addition" must be accompanied with its documentation files. Disclaimer I make no warranties, either express or implied, regarding the fitness of the “ARA Scripting Addition” for any particular purpose. Use the “ARA Scripting Addition” at your own risk. The author claims no liability for data loss or any other problems caused directly or indirectly by the “ARA Scripting Addition”. 
